Saving and Restoring Component Configurations17

Video output components provide functions for saving the current configuration of a video output component and later restoring the configuration. This section describes these functions.

To save the current configuration of a video output component, call the QTVideoOutputSaveState function.

To restore a previously saved configuration of a video output component, call the QTVideoOutputRestoreState function.

QTVideoOutputRestoreState

You use the QTVideoOutputRestoreState function in your software to restore the previously saved state of a video output component.



 
pascal ComponentResult QTVideoOutputRestoreState (

                     QTVideoOutputComponent vo, 

                     QTAtomContainer state);

vo: Specifies the instance of a video output component for this request. Your software obtains this reference when calling the Component Manager's OpenComponent or OpenDefaultComponent function.
state: A QT atom container, returned earlier by the QTVideoOutputSaveState function, that contains state information for the video output component.

DISCUSSION

If your software saves state information to disk, it must read the QT atom container structure from disk before calling QTVideoOutputRestoreState .

When your software restores state information for a video output component, the current display mode may change. Because of this, your software must call QTVideoOutputRestoreState before calling QTVideoOutputStart .

QTVideoOutputSaveState

You use the QTVideoOutputSaveState function to save state information for an instance of a video output component.



 
pascal ComponentResult QTVideoOutputSaveState (

                     QTVideoOutputComponent vo, 

                     QTAtomContainer *state);

vo: Specifies the instance of a video output component for this request. Your software obtains this reference when calling the Component Manager's OpenComponent or OpenDefaultComponent function.
state: Contains a pointer to complete information about the video output component's current configuration.

DISCUSSION

When your software saves state information for an instance of a video output component, it can restore this information when reconnecting to the component by calling the QTVideoOutputRestoreState function.

When your software calls QTVideoOutputSaveState , it must dispose of the QT atom container returned by the function by calling DisposeQTAtomContainer .